Skip to content

docs(dropdown): document [mode] input with detailed JSDoc and nav example#684

Open
giulio-leone wants to merge 1 commit into
italia:mainfrom
giulio-leone:docs/603-mode-input-documentation
Open

docs(dropdown): document [mode] input with detailed JSDoc and nav example#684
giulio-leone wants to merge 1 commit into
italia:mainfrom
giulio-leone:docs/603-mode-input-documentation

Conversation

@giulio-leone

Copy link
Copy Markdown
Contributor

Summary

Closes #603

Changes

JSDoc improvements on both ItDropdownComponent.mode and ItDropdownItemComponent.mode:

  • Documents all three values: 'button' (default), 'link', 'nav'
  • Explains rendering behavior (element type, CSS classes) for each mode
  • Documents automatic mode propagation from parent to child components
  • Adds @default tag for IDE autocompletion

New demo component (dropdown-nav-example):

  • Shows mode="nav" usage inside a <nav class="navbar"> context
  • Includes Italian-language description explaining the nav mode behavior
  • Demonstrates active and disabled states

Verification

  • 109/109 tests passing (double gate)
  • 0 lint errors (8 pre-existing warnings)
  • Prettier + ESLint pass via lint-staged

⚠️ This reopens #640 which was accidentally closed due to fork deletion.

…mple

Improve JSDoc for the mode @input on both ItDropdownComponent and
ItDropdownItemComponent, documenting the three available values (button,
link, nav) with their rendering behavior, CSS classes, and use cases.

Add a new dropdown-nav-example demo component showing mode="nav" inside
a navbar context, including the explanatory description text in Italian.

Closes italia#603

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Doc] Mancanza di una spiegazione esaustiva sull'input [mode] (<it-dropdown> e <it-dropdown-item>)

1 participant